File        : PUTFILE
Date        : 07-Dec-97
Author      :  A.Thoukydides, 1995, 1996, 1997
Description : Description of the PC PUTFILE command that is part of the
              ARMEdit suite.


INTRODUCTION

The "PUTFILE" command is a replacement for the command of the same name that
was supplied with Acorn's software PC emulator. It allows DOS files to be
transferred to RISC OS. To use this command it is necessary to load the
ARMEdit module before starting the PC front-end.


USAGE

The syntax is:

    PUTFILE [/?] [/M] [/P] [/S] [/W] <DOS path> [<RISC OS path>]

where

    /?              - Displays some help text.
    /M              - Enable multitasking during copying.
    /P              - Prompts before copying each file.
    /S              - Copy subdirectories.
    /W              - Disable use of the "Save as" window.
    <DOS path>      - Wildcarded source DOS file specification to copy.
    <RISC OS path>  - The destination RISC OS path.

The source path may include standard DOS wildcards, i.e. "?" to match a
single character or "*" for multiple characters. Files are matched using the
same rules as used by other DOS commands.

If no destination filename is specified then the source filename is used with
various character transformations performed. Without the "/W" switch a RISC
OS "Save as" window is used to select a suitable destination; this requires
!ARMEdit to be running.

The filetype is selected using the mappings set up using the DOSMap command.
This is initially cached when the ARMEdit module starts, but may be reread at
any time using the command ARMEdit_DOSMap.


THINGS TO DO

The following are changes that may be made to the PUTFILE command sometime in
the future.

    None at the moment!


VERSION HISTORY

0.00 (12-Nov-95)    Original development version.

0.01 (14-Nov-95)    Added version number and copyright message.

0.02 (17-Nov-95)    Uses correct HPC service identifier.
                    Changed to a .COM file to make it smaller.
                    Made error checking more comprehensive and added help text.
                    Filetype of destination file is based on file extension.

0.04 (16-Dec-95)    Uses real HPC.

0.05 (17-Dec-95)    Improved filename translation.

1.00 (12-Jan-96)    First official release version.

1.01 (11-Mar-96)    Version number updated to match the module.

1.02 (06-Aug-96)    Date and time stamps are preserved on copied files.
                    Added support for Acorn's software PC emulator.

1.03 (21-Feb-97)    Speeded up transfer when multitasking.
                    Added option to use a RISC OS "Save as" window.
                    Included support for wildcards and recursion.

1.04 (07-Dec-97)    Version number updated to match the module.